home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
bbs_soft
/
pcbmail1.zip
/
PCBMAIL.DOC
< prev
next >
Wrap
Text File
|
1993-06-02
|
10KB
|
174 lines
+--------------------------[ PCBMail Ver 1.01 ]----------------------------+
| Written By Gary Meeker 06/01/93 Updated 06/02/93 |
| SYSOP: SHARP Technical Support Line BBS Lawrenceville, GA |
| (404) 962-1788 300-14400 Baud. 24 Hours |
+---------------------------------------------------------------------------+
V1.00 06/01/93 - Initial Release
V1.01 06/02/93 - Added configuration options line
Added 'F' option in BltScan list to force a bulletin
Changed scan to scan for bulletins based on the length of
the list if less characters than number of bulletins exist.
Fixed problem reading PCBOARD.DAT files that have commas
in the Name of the BBS or the F-Key lines. (Stupid me, I
know better, having been bit before)
PCBMail is designed to enhance PCBoard 15.0's built in QWK Mail features.
It is is installed in PCBQWK.BAT by changing the file to:
IF EXIST ABORTQWK GOTO END
IF %1==COMPRESS PCBMAIL %3 %4
IF %1==COMPRESS IF EXIST USERS.SYS DEL USERS.SYS
IF %1==COMPRESS PKZIP -ex -m %2 @%4
IF %1==EXTRACT PKUNZIP -o %2 %3
IF %1==EXTRACT PCBMAIL /I %3
:END
During Compression PCBMail will read the CONTROL.DAT file PCBoard created
and rewrite a new one with ALL the conferences the User is allowed to Join.
PCBMail will also create a DOOR.ID file and append the PCBQWK.LST file
(referenced as %4 above) with the name of DOOR.ID, WELCOME, NEWS, GOODBYE
and any Bulletins that are included during scanning. If a NEWFILES.DAT file
is present in the work directory then it will be added to the PCBQWK.LST
file to be included in the .QWK file automatically, but PCBMail does not
generate one itself. This could be added to PCBMail.PPE easily enough and
I might condsider it for a future addition.
During Extraction PCBMail will scan the .MSG file and remove any message
addressed to PCBMAIL. If the Subject is ADD or DROP then the conference
will be added or removed for scanning also. Currently message pointer
adjustments are not supported but I'll work on it.
PCBMail needs a simple configuration file as follows:
Lawrenceville, GA
(404) 962-1788
CDWNGB
FYYYYYYYYYNNNNNNNNNN
Line 1 is the City & State of your BBS
Line 2 is the Telephone Number of the BBS
Line 3 is the options list (the order is not important):
B: Scan and include new bulletins
C: Write full CONTROL.DAT, otherwise use the one from PCBOARD
D: Include DOOR.ID file
G: Include the GOODBYE file
F: Include the NEWS file regardless of date (forced)
N: Include the NEWS file if new to user
W: Include the WELCOME file
Line 4 is the Main Board bulletins to scan for inclusion. A 'Y' means check
the bulletin & 'N' (or almost anything else) means don't bother.
If a bulletin is newer than the Users Last Date/Time on it will
be copied (with the appropriate naming convention) and included
in the .QWK packet). 'F' will force the bulletin regardless of date.
Only normal files are copied and Graphic or RIPscript files will not
be copied regardless of the Users current mode.
The configuration file should be in the same directory as the program file.
(or PCBMail will check the environment for *.CFG and use the path it points
to look for the configuration file.)
PCMail also needs a USERS.SYS file which will normally not be available.
To get it you also need to install PCBMail.PPE in your PCBTEXT files
entries 676, 679, 680, 685 & 686. To do this run MKPCBTXT on each of your
PCBTEXT files and change the lines to:
!C:\PCB\PPE\PCBMAIL.PPE X +OldText
where C:\PCB\PPE\PCBMAIL.PPE is the full Drive:Path\PCBMAIL.PPE of where
you placed the file and X is the number of the prompt being replaced.
This will allow a USERS.SYS file to be created when prompt 676 or 679 is
issued and USERS.SYS will be read and deleted when prompt 680, 685 or 686
is issued. OldText is the original Text of the prompt so it still gets
logged. If OldText is not present then PCBMail.PPE will also write a line
to the log with the origional text.
╒══════════════════════════════════════════════════════════════════════════════╕
│ Record No.: 676 Record Length: 70 Justification: Left │
├──────────────────────────────────────────────────────────────────────────────┤
│Creating QWK Packet, please wait... │
│!C:\PCB\PPE\PCBMAIL.PPE 676 │
│ or │
│!C:\PCB\PPE\PCBMAIL.PPE 0 │
╘══════════════════════════════════════════════════════════════════════════════╛
╒══════════════════════════════════════════════════════════════════════════════╕
│ Record No.: 677 Record Length: 70 Justification: Left │
├──────────────────────────────────────────────────────────────────────────────┤
│Error compressing file. │
│!I:\PCB\PPE\PCBMAIL.PPE 677 +Error compressing file. │
╘══════════════════════════════════════════════════════════════════════════════╛
╒══════════════════════════════════════════════════════════════════════════════╕
│ Record No.: 679 Record Length: 70 Justification: Left │
├──────────────────────────────────────────────────────────────────────────────┤
│Extracting messages, please wait... │
│!C:\PCB\PPE\PCBMAIL.PPE 679 │
╘══════════════════════════════════════════════════════════════════════════════╛
╒══════════════════════════════════════════════════════════════════════════════╕
│ Record No.: 680 Record Length: 70 Justification: Left │
├──────────────────────────────────────────────────────────────────────────────┤
│Error extracting messages. │
│!C:\PCB\PPE\PCBMAIL.PPE 680 +Error extracting messages. │
╘══════════════════════════════════════════════════════════════════════════════╛
╒══════════════════════════════════════════════════════════════════════════════╕
│ Record No.: 685 Record Length: 70 Justification: Left │
├──────────────────────────────────────────────────────────────────────────────┤
│Message(s) successfully inserted. │
│!C:\PCB\PPE\PCBMAIL.PPE 685 +Message(s) successfully insetted. │
╘══════════════════════════════════════════════════════════════════════════════╛
╒══════════════════════════════════════════════════════════════════════════════╕
│ Record No.: 686 Record Length: 70 Justification: Left │
├──────────────────────────────────────────────────────────────────────────────┤
│Message insertion failed. │
│!C:\PCB\PPE\PCBMAIL.PPE 686 +Message insertion failed. │
╘══════════════════════════════════════════════════════════════════════════════╛
PCBMAIL.PPE also needs a configuration file named PCBMAIL.CNF and it must be
in the same directory as the .PPE file. It contains 8 lines as follows:
Do you want to receive these messages
QWK Packet Aborted by User.
Creating QWK Packet, please wait...
Error compressing file
Extracting messages, please wait...
Error extracting messages.
Message(s) successfully inserted.
Message insertion failed.
Line 1: The prompt to ask the User if they want the packet (more later)
Line 2: Text to be displayed and logged if they answer NO
Line 3: The text to be shown to the User for Prompt 676
Line 4: The text to be shown to the User for Prompt 677
Line 5: The text to be shown to the User for Prompt 679
Line 6: The text to be shown to the User for Prompt 680
Line 7: The text to be shown to the User for Prompt 685
Line 8: The text to be shown to the User for Prompt 686
If you want the User to be prompted you need to replace the 676 in prompt 676
with 0. This gives the User a chance to abort the packet after seeing how many
messages it contains. If you don't use this then you can delete the line:
IF EXIST ABORTQWK GOTO END
from the PCBQWK.BAT file as it not needed. If the User aborts the transfer the
text in Line 2 of the .CFG file will be shown to the User and Logged. You may
leave this line blank in which case nothing will be logged or displayed to the
User. If not blank, you will get three lines in the Log when an abort takes
place, ie.
QWK Packet Aborted by User.
!I:\PCB\PPE\PCBMAIL.PPE 677 +Error compressing file.
Capture Aborted. Read Pointers Restored ...
It would be nice if PCBoard would not log a line starting with !filespec.ppe
and leave it up to the .PPE to log the appropriate text, but such is life.
You may use 676 in a 'STANDARD' PCBTEXT file to avoid the unusual prompt from
messing up an automated script and use 0 in all your other PCBTEXT files. You
will want to include all the other changes in all PCBTEXT entries or PCBMail
will most likely not function properly.
Any comments would be appreciated (any donations would also be appreciated,
but the idea was to enhance the internal features to avoid the need for
buying a door if you didn't need the additional features they support,
so don't sweat it, this is FREEWARE.)